home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / wordproc / elvb18x2.arj / README.GRR < prev    next >
Text File  |  1993-11-30  |  4KB  |  94 lines
  1. This is a BETA release of elvis (free vi clone) for OS/2.  It is based
  2. on the 1.8c beta sources announced by Steve Kirkendall in comp.editors, 
  3. but it contains additional modifications and bug fixes by Kai Uwe Rommel
  4. and myself.
  5.  
  6. This version is a hybrid 16/32-bit executable.  It is almost entirely
  7. 32-bit code, but the "viomode" features use a number of (16-bit) VIO 
  8. routines.  These features are *not* enabled by default; they can be
  9. turned on via "set viomode" (or the abbreviated version, "set vm").
  10. Note, however, that (1) use of these features over a telnet link is
  11. not supported (which is why they are switch-selectable), and (2) not 
  12. all of the features can be turned on interactively after elvis has al-
  13. ready started--that is, you must use the EXINIT variable to set viomode
  14. ahead of time in order to benefit from the initialization features (see
  15. below).
  16.  
  17. Here's a list of the main changes to the 1.8c beta (not counting simply
  18. getting elvis to compile correctly):
  19.  
  20.   generic stuff:
  21.     - handle filenames with spaces correctly (or more correctly, at
  22.       least...ASCII 255 is no longer supported in filenames)
  23.     - don't convert filenames to lowercase under OS/2
  24.     - handle : after :! correctly; also don't overwrite second (and
  25.       later) :! command(s) with their own output
  26.     - print gcc version and compilation date with :version command
  27.  
  28.   with either ":set viomode" at runtime or EXINIT=set viomode:
  29.     - do smooth backscrolling
  30.     - change cursor shape in insert mode
  31.     - use shorter beeps (not longer than key repeat rate)
  32.  
  33.   only with EXINIT=set viomode:
  34.     - set ANSI mode at startup (if necessary) and turn off again at exit
  35.     - restore screen colors at exit (most of the time, at least)
  36.  
  37.   NOT done:
  38.     - resize VIO window (or fullscreen, if possible) if user does "set
  39.       lines=XX" (or "set cols=XX")
  40.  
  41. These are the included executables:
  42.  
  43. 11-30-93  10:43a      8214   ctags.exe
  44. 11-30-93  10:42a    122390   elvis.exe
  45. 11-30-93  10:43a      5654   elvprsv.exe
  46. 11-17-93  11:58a      3606   elvrec.exe
  47. 11-30-93  10:43a      3606   fmt.exe
  48. 11-17-93  11:57a      5142   ref.exe
  49. 11-30-93  10:44a      3606   wildcard.exe
  50.  
  51. Aside from the preserve and recover programs, these are all substantially
  52. similar to their Unix counterparts, but they are also documented at the end
  53. of the formatted docs (in the man-pages section):
  54.  
  55. 11-30-93   1:20p    201115   Elvisman.txt
  56.  
  57. As for setup, you'll need two of the emx runtime DLLs; I've included the
  58. ones from emx 0.8f (since that's what I used to compile), but there shouldn't
  59. be any problems using the newer 0.8g versions.  Copy these to a directory
  60. in your LIBPATH:
  61.  
  62.  3-18-93  11:12a     38462   emx.dll
  63.  1-03-93   9:37p     74402   emxlibc.dll
  64.  
  65. You'll also need a termcap file and a few environment variables:
  66.  
  67. 11-16-93  10:36p      3340   termcap.dat
  68.  
  69. set TERMCAP=c:/emx/etc/termcap.dat
  70. set TERM=pcbios
  71.  
  72. These are the relevant settings in my config.sys; note that the direction
  73. of the slashes is generally important to emx.  The "pcbios" term type lets
  74. me use either elvis 1.[78] + termcap or elvis 1.5 + VIO.  If you don't have
  75. 1.5 lying around (which basically ONLY worked with VIO routines and there-
  76. fore needed TERM=pcbios or nothing at all), use any name you wish.  The 
  77. default termcap.dat comes with "ansi", "window" and "mono" terminal types,
  78. and I've added my pcbios entry (like "ansi" but with different colors) and
  79. a list of valid color values (SGR).
  80.  
  81. set TMP=C:\tmp
  82.  
  83. The TMP variable may not actually be necessary, but elvis uses it if it
  84. finds it.  The backslash may or may not be necessary (as opposed to a for-
  85. ward slash), but it is sufficient.
  86.  
  87. set EXINIT=set viomode
  88.  
  89. As noted above, this enables a number of nice features; for most systems
  90. it's probably a desirable setting.
  91.  
  92. Greg Roelofs
  93. 30 November 1993
  94.